Inside Macintosh: QuickDraw GX Objects /

Chapter 7 - View-Related Objects / View-Related Objects Reference

View Port Functions / Creating and Manipulating View Port Objects

GXDisposeViewPort

You can use the GXDisposeViewPort function to delete a view port object.

void GXDisposeViewPort(gxViewPort target);

target

A reference to the view port object to dispose of.

DESCRIPTION

The GXDisposeViewPort function disposes of the target view port. If the target view port is a parent, its children are removed from their position in the hierarchy and each is made the root of a new hierarchy.

SPECIAL CONSIDERATIONS

If the target view port is a parent associated with a window, its child view ports lose their association with the window.

ERRORS, WARNINGS, AND NOTICES

Errors
invalid_viewPort_reference

SEE ALSO

For an example of the use of this function, see page 7-41.

For information about view port hierarchies, see "Parent and Child View Ports" beginning on page 7-18.